home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dirut / filmatch.zip / FILMATCH.DOC < prev    next >
Text File  |  1991-09-03  |  5KB  |  148 lines
  1. FILMATCH.EXE   Copyright (c) 1991 by Warrick Wilson
  2.  
  3.  
  4.  
  5.  
  6. Overview
  7. --------
  8.  
  9. This shareware utility checks a list of filenames against a specified
  10. sequence of subdirectories.  If a file in the list is missing from a
  11. subdirectory, FILMATCH produces a message.  The size, and optionally date
  12. and time, of each file is checked in each of the subdirectories.  If
  13. a difference is found, FILMATCH displays a warning and a summary of the
  14. differences found.
  15.  
  16. NOTE: FILMATCH ALWAYS checks the size.  You may specify date and/or
  17. time checking using command line arguments (described later).
  18.  
  19. FILMATCH does NOT attempt to verify that the contents of the files
  20. are the same.  It uses the size, date and time information only.
  21.  
  22. FILMATCH is useful when you need to know that certain files are the
  23. same across network drives or between diskettes and a hard disk.
  24. Install programs can benefit from this utility.
  25.  
  26.  
  27. Licence Stuff
  28. -------------
  29.  
  30.  
  31. The programs and documentation in this archive are
  32.       Copyright (c) 1991 by Warrick Wilson
  33.  
  34. No guarantee is made as to the functionality of this software.  It has
  35. been tested and found to do what I claim it does.  There are limitations
  36. and environments that I can't test.  Some are described later.  If
  37. FILMATCH doesn't do what you want, don't keep it and send no money.
  38.  
  39. If you do try it and find that it doesn't work, I would appreciate
  40. knowing about it.  Drop me a line at the address below and give me
  41. the specifics.  Maybe there's something I can do in a later release.
  42.  
  43. Registration details are listed at the end of this file.
  44.  
  45.  
  46. Invoking FILMATCH
  47. -----------------
  48.  
  49. The command line arguments are:
  50.  
  51.  
  52. FILMATCH [-dt] <listname> <dir1> <dir2> [dir3 ...]
  53.  
  54.    -dt         if present, d causes matches on dates
  55.                            t causes matches on times
  56.  
  57.    listname    name of the file containing the filenames to check
  58.                for, listed one per line.  Wild cards are not
  59.                permitted.
  60.  
  61.             Example:
  62.  
  63.                run.bat                    c:\run.bat
  64.                myprog.exe     NOT         d:\bin\*.exe
  65.                myprog.doc     ===         myprog.*
  66.  
  67.    dir1        master subdirectory that all sizes, dates and times
  68.                are based on
  69.  
  70.    dir2, etc.  other subdirectories to match against
  71.  
  72.  
  73. Examples:
  74. ---------
  75.  
  76. FILMATCH a:\files.lst a:\ c:\
  77.  
  78.    
  79.    This command verifies that all files in the file A:\FILES.LST
  80.    are found on both A:\ and C:\.  The comparison is based on size
  81.    only.  The size will be taken from the file in A:\.
  82.  
  83. FILMATCH -t a:\files.lst a:\ c:\
  84.  
  85.    This command is the same as the command above, but comparisons
  86.    between files are done on size and time.
  87.  
  88. FILMATCH -dt x:\network\project\files.lst x:\network c:\project
  89.  
  90.    This command forces comparisons between size, date and time.
  91.    Each file found in the X:\NETWORK\PROJECT\FILES.LST file will
  92.    be searched for in X:\NETWORK and C:\PROJECT.  If the file size,
  93.    date or time in C:\PROJECT differs from the corresponding value 
  94.    in X:\NETWORK, FILMATCH will display an error message.
  95.  
  96.  
  97. Return Values
  98. -------------
  99.  
  100. If arguments are incorrect, FILMATCH displays a warning message. 
  101. Errors in matching are displayed also.
  102.  
  103. FILMATCH returns a DOS errorlevel of 0 if no differences are found. 
  104. The errorlevel is 1 or greater when errors are found.  This means
  105. that you may use FILMATCH in a batch file and check a copying step,
  106. for example.
  107.  
  108.  
  109.  
  110. Supported Environments
  111. ----------------------
  112.  
  113. FILMATCH has been used successfully over an IBM Token Ring Network. 
  114. It has been tried on a TOPS network also, but it didn't work.  Since
  115. I can't figure out why it didn't work, I suggest not using over a
  116. TOPS network.
  117.  
  118.  
  119. FILMATCH should work well on any version of DOS greater than 2.0.
  120.  
  121.  
  122.  
  123. Registration
  124. ------------
  125.  
  126.  
  127. FILMATCH is a shareware product.  You are free to make copies of FILMATCH
  128. and distribute them to your friends and BBSs, provided you include all
  129. program and documentation files unchanged.
  130.  
  131. The registration fee for FILMATCH is $5.00.  Site licences, which count as
  132. 20 or more copies, are $100.00.  Send registration fees to:
  133.  
  134.                                Warrick Wilson
  135.                            40 Ellis Crescent North
  136.                               Waterloo, Ontario
  137.                               Canada    N2J 3G4
  138.                       519-725-3610 after 6 p.m. Eastern Time
  139.  
  140. See the file INVOICE.DOC for complete registration information.
  141.  
  142. Shareware authors who are interested in distributing FILMATCH as part
  143. of their product should contact the above address to negotiate
  144. licensing arrangements.
  145.  
  146.  
  147. Thank you for your interest in FILMATCH!
  148.